PRD: AI 角色化研发工作流 Web 平台

版本：v0.1 ｜ 创建日期：2026-05-08 ｜ 状态：已确认

1. 背景与目标

  • 业务背景：个人开发者在使用 AI 辅助编程时，常因全盘依赖单一模型导致逻辑跑偏、陷入反复修正的泥潭。真实的软件开发需要分层决策与文档约束，但个人开发者缺乏模拟这一过程的工具。
  • 核心目标：
    1. 提供一个轻量级 Web 平台，将研发流程固化为“产品-架构-研发-QA” 4 个文档流转节点。
    2. 通过“强节点确认”和“结构化上下文传递”，降低 AI 编码时的理解偏差。
    3. 实现纯浏览器端的本地化运行，零后端存储，保障用户 API 隐私。
  • 非目标 / 不做项：本期不包含任何服务器端的用户账号体系与云端数据同步；不内置大模型计费/代付系统；不开放系统级提示词（Prompt）的修改权限；不包含最终的代码生成执行环境（仅产出 Markdown 文件）。

2. 用户与场景

  • 目标用户：习惯使用 Cursor、Claude Code 等 AI 编程工具的个人开发者或 1~3 人微型创业团队。
  • 核心场景：在获得一个新的软件 Idea，或者准备开发一个复杂功能模块前，用户打开本平台，通过对话将模糊的想法转化为严谨的工程执行文档，然后再去 IDE 中写代码。
  • 痛点：缺乏前期设计导致后续代码重构成本极高；手写需求和架构文档过于耗时。

3. 用户故事（Given-When-Then 格式）

  • US-001 [模型配置]：作为开发者，当我首次使用平台时，我希望能够为 4 个不同的角色分别配置 API Key 和对应的模型型号，以便我可以根据任务难度分配不同智力水平的模型（如选优选大模型做架构，便宜模型做 QA）。
  • US-002 [节点生成与确认]：作为开发者，当我在节点 1（产品对齐师）输入需求后，我希望系统生成文档后暂停，以便我能在界面上审核、修改该文档，确认无误后再点击推进到下一个节点。
  • US-003 [单点回滚与手动更新]：作为开发者，当流程走到节点 3 时我发现需求有遗漏，我希望退回节点 1 修改 PRD。当我确认修改后，我希望下游节点（节点 2、3）变为“已失效”状态，以便我可以手动依次点击重新生成它们。
  • US-004 [局部重试]：作为开发者，当 API 调用由于网络或 Token 限制中断时，我希望看到明确的报错，并保留已经生成的一半文字，以便我可以点击“重试”继续生成，而不是全部重来。
  • US-005 [产物导出]：作为开发者，当所有流程结束时，我希望在左侧看到完整的文件树，并在右侧预览内容，以便我可以手动逐个复制 Markdown 文件内容到我的本地开发工具中。

4. 功能清单

编号 功能名 描述 优先级 关联用户故事
F-001 全局设置面板 支持为 4 个 Gem 独立设置 API URL、Key、Model Name。数据仅存入 LocalStorage。 P0 US-001
F-002 工作流流转引擎 实现四个节点的线性状态机（生成中、待确认、已确认、已失效），控制上下文文件的精准投喂。 P0 US-002
F-003 富文本/Markdown 编辑器 节点暂停时，允许用户直接在网页上编辑 AI 生成的产物内容。 P0 US-002
F-004 节点作废与重跑机制 上游节点被修改并重新确认后，自动将依赖其产物的所有下游节点状态置为“已失效/需更新”，并暴露重新生成按钮。 P0 US-003
F-005 极简异常处理 捕获 API 超时或报错，中止流转，红字提示并提供重试按钮，保留流中已接收的文本。 P1 US-004
F-006 产物预览与复制面板 左侧展示生成的 PRD.md, DESIGN.md, TASKS.md 等列表，右侧展示详情与“一键复制”按钮。 P0 US-005

5. 非功能需求

  • 性能：首屏加载时间 < 2秒。
  • 可用性：所有用户输入和流转状态必须实时持久化到浏览器的 LocalStorage 或 IndexedDB，防止意外刷新导致数据丢失。
  • 安全与权限：API Key 必须以明文/简单加密形式仅存在本地，绝对禁止任何形式的网络上报行为。

6. 边界与异常

  • 空状态：用户未配置 API Key 直接点击生成时，阻断操作并弹出全局设置面板。
  • 失败处理：LLM 吐出的数据如果不符合 Markdown 规范，系统不强制校验，按原样渲染，交由用户在“确认环节”手动修正。
  • 浏览器存储超限：如 IndexedDB 满载（极罕见），提示用户清理历史会话。

7. 依赖与集成

  • 依赖的已有系统/服务：依赖用户自行提供的 OpenAI/Anthropic/Google 等兼容 API。
  • 第三方账号/API：无。

8. 验收标准

  • AC-001：用户能在断网刷新页面后，依然看到上一次填写的 API Key 和进行到一半的工作流状态。
  • AC-002：修改节点 1 后，节点 2、3、4 的 UI 会出现明确的“视觉警告（如变灰或红点）”，提示用户上下文已过期。
  • AC-003：用户可以成功复制最终生成的任意 Markdown 文件，且格式与标准 Markdown 语法完全一致。

FLOW: AI 角色化研发工作流 Web 平台

主路径

主流程 M1：标准的四步流转与产出

  1. 用户进入 Web 页面，首次访问触发侧边栏 [全局设置面板]。
  2. 用户配置 4 个阶段的 API Key 与模型，点击保存。
  3. 系统展示主工作区，状态处于 [节点1：产品对齐 - 等待输入]。
  4. 用户在输入框提供白话需求，点击“开始对齐”。
  5. 系统调用配置好的 API，流式输出 PRD.md 和 FLOW.md。
  6. 生成完毕，节点 1 状态变为 [待确认]，出现“修改”和“确认并进入下一节点”按钮。
  7. 用户点击“确认”，系统进入 [节点2：架构设计]，将节点 1 的产物作为上下文不可见地投喂给节点 2 的 API。
  8. 节点 2 生成 DESIGN.md，暂停等待确认。
  9. 用户依次完成节点 3（生成 TASKS.md）和节点 4（生成 ACCEPTANCE.md）的确认。
  10. 系统进入 [终态：完成区]，左侧展示文件树，右侧展示选中的文件内容与复制按钮。
  11. 用户挨个点击复制，流程结束。

异常路径

异常 E1：API 调用异常（网络/Token不足）

  • 触发条件：在任意节点的生成过程中，API 接口返回非 200 状态码，或请求超时。
  • 系统行为：立即停止流式输出渲染。在当前生成区域的底部抛出红色错误提示框（显示原生报错信息）。保留已经生成的残缺文本。
  • 用户可执行操作：用户点击错误框旁边的“重试”按钮，系统清空残缺文本，使用相同的上下文重新发起 API 请求。

异常 E2：中途返回修改（单点回滚）

  • 触发条件：当前工作流已经推进到节点 3 或之后，用户主动点击节点 1（产品）或节点 2（架构）的“返回编辑”按钮。
  • 系统行为：系统将目标节点（如节点 1）的状态改回 [编辑中]。
  • 用户可执行操作：用户修改 PRD.md 的文本，并点击“保存并确认”。
  • 系统行为：系统将节点 2、3、4 的状态全部标记为 [已失效/需更新]（UI 标黄或显示警告图标），并禁用总产物区的复制功能。
  • 用户可执行操作：用户必须回到节点 2 的 UI 面板，点击“重新生成”，以此类推手动推进。

状态变化

  • 单节点状态机：等待输入 → 生成中 → 待确认（此时可编辑） → 已确认（传导给下一节点） → 已失效（当上游变更时触发）。
  • 全局会话状态机：配置校验 → 流转中 → 全量完成。

VibeCoding 导航：⬅️ 辅助工具 | 🏠 00-VibeCoding | ➡️ 09-AI辅助编程现状分析